package com.robertbak.geolocation.interfaces
{
	[Bindable]
	/**	 
	 * The Position interface is the container for the geolocation information returned by this API. 
	 * This version of the specification allows one attribute of type Coordinates and a timestamp. 
	 * Future versions of the API may allow additional attributes that provide other information about this position (e.g. street addresses).
	 * @see http://dev.w3.org/geo/api/spec-source.html#position_interface
	 */
	public interface IPosition
	{
		/**
		 * The coords attribute contains a set of geographic coordinates together with their associated accuracy, 
		 * as well as a set of other optional attributes such as altitude and speed.
		 * @return 
		 */
		function get coords():ICoordinates;
		/**
		 * The timestamp attribute represents the time when the Position object was acquired.
		 * @return 
		 */
		function get timestamp():Date;
		/**
		 * Availible only in Gears.
		 * @return 
		 */
		function get address():IAddress; 
	}
}